home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / dviware / ln03 / rmcs / dviln03.hlp < prev    next >
Text File  |  1991-09-29  |  13KB  |  352 lines
  1. 1 DVILN03
  2.  
  3.   DVILN03 is a program to convert TeX Device Independent (DVI) output
  4.   files into a form suitable for printing on a Digital LN03 laser
  5.   printer. The "Local Guide to DVILN03" contains full details of this
  6.   program. Please report any problems or suggestions to Brian Hamilton
  7.   Kelly, or by sending electronic mail to user TEX.
  8.  
  9.   Format:
  10.  
  11.     DVILN03 file-name
  12.  
  13.   If the program terminates successfully, it will produce two new files,
  14.   with the same name, but different types.
  15.  
  16.     file-name.LN3  - the output file, suitable for printing on a Digital
  17.                      LN03 laser printer using the TEXPRINT command.
  18.  
  19.     file-name.TYP  - the log file, recording messages sent by DVILN03 to
  20.                      the terminal, plus additional information.
  21.  
  22.  
  23. 2 Parameter
  24.  
  25.   file-name
  26.  
  27.   Specifies the TeX DeVice Independent (DVI) file to be converted to 
  28.   a form suitable for printing on a Digital LN03 laser printer. 
  29.  
  30.  
  31. 2 Command_Qualifiers
  32.  
  33. /STARTING_PAGE
  34.  
  35.  /STARTING_PAGE=starting_page_number             (default = *)
  36.  
  37.  This qualifier specifies the first TeX page to be converted.  A
  38.  wildcard qualifier may be used, in which case, the first  page number
  39.  matching the specification is used. DVILN03  accepts TeX multiple page
  40.  specifiers e.g. 1.*.19.4; see the user guide for further details.
  41.  
  42.  If you omit this qualifier, DVILN03 will start at the first page of the
  43.  document.
  44.  
  45.  
  46.  
  47. /NUMBER_OF_PAGES
  48.  
  49.  /NUMBER_OF_PAGES=number_of_pages_to_print       (default=1000000)
  50.  
  51.  This qualifier specifies the number of TeX pages to be converted.
  52.  If you omit this qualifier, DVILN03 will print the entire document.
  53.  
  54.  
  55.  
  56. /ORIENTATION
  57.  
  58.  /ORIENTATION=image_orientation                  (default=PORTRAIT)
  59.  
  60.  This qualifier specifies the orientation of the document as it will be
  61.  printed on the Digital LN03 printer. Two options are available:
  62.             
  63.    /ORIENTATION = PORTRAIT
  64.    The output is intended to be printed taller than it is wide.
  65.  
  66.    /ORIENTATION = LANDSCAPE 
  67.    The output is intended to be printed wider than it is tall.
  68.  
  69. /OUTPUT
  70.  
  71.  /OUTPUT=file_spec
  72.  
  73.  The output (ready for printing on an LN03 printer) will normally be 
  74.  written in the current directory, with the same name as the DVI file
  75.  and file extension `.LN3'.  The /OUTPUT qualifier, which requires a
  76.  partial file specification, can be used to override some or all of
  77.  these defaults.
  78.  
  79.  This qualifier can be particularly useful for users with limited disk 
  80.  quota who can use it to divert output to a scratch disk, or even send
  81.  it directly to a spooled printer.
  82.  
  83. /LOG
  84.  
  85.  /LOG[=file_spec]
  86.  /NOLOG
  87.  
  88.  This allows the user to control whether the log file will be kept after
  89.  processing the document and optionally to provide an alternative file 
  90.  specification for the file.  The default for this file is to write it 
  91.  in the current directory, with the same name as the DVI file, but with 
  92.  file type `.TYP'.  Any value provided to the /LOG qualifier allows the
  93.  user to override some or all of these defaults.  If /LOG is specified,
  94.  with or without a file specification, the log file will always be 
  95.  retained, even if no error or warning messages have been issued.
  96.  
  97.  If /NOLOG is specified, the file will always be deleted at the end of
  98.  processing, even if an error or warning message has been issued.
  99.  
  100.  The default action, if neither qualifier is present, is to delete the
  101.  file if no error or warning messages were issued, but to retain it
  102.  otherwise.
  103.  
  104. /VERBOSE
  105.  
  106.  /VERBOSE (deafult)
  107.  /NOVERBOSE
  108.  
  109.  Controls the amount of progress messages sent to the user's terminal.
  110.  All messages go to the log file (see /LOG) in the usual fashion, but 
  111.  if /NOVERBOSE has been specified, the terminal only shows the total 
  112.  number of bytes of fonts downloaded and the page numbers processed;
  113.  warning and error messages still appear, of course.
  114.  
  115. /LEFT_MARGIN
  116.  
  117.  /LEFT_MARGIN=left_page_margin_offset          (default=300px)
  118.  
  119.  This qualifier specifies the distance (in the given unit) between the 
  120.  physical left-hand edge of the paper and TeX's logical left-hand edge 
  121.  of the paper. Device Independent (DVI) files are produced by TeX under 
  122.  the assumption that this distance is one inch. The resolution of the 
  123.  Digital LN03 printer is 300 pixels/inch; the default value is therefore
  124.  set to 300px. `px' is used to specify pixels as the unit for this
  125.  dimension; any of TeX's standard physical units (e.g. pt, mm, in) may
  126.  be used instead.
  127.  Use this qualifier with care.
  128.  
  129. /TOP_MARGIN
  130.  
  131.  /TOP_MARGIN=top_margin_offset                (default=300px)
  132.  
  133.  This qualifier specifies the distance (in the given unit) between the 
  134.  physical top edge of the paper and TeX's logical top edge of the paper. 
  135.  Device Independent (DVI) files are produced by TeX under the assumption
  136.  that this distance is one inch. The resolution of the Digital LN03 
  137.  printer is 300 pixels/inch; the default value is therefore set to
  138.  300px. `px' is used to specify pixels as the unit for this dimension;
  139.  any of TeX's standard physical units (e.g. pt, mm, in) may be used
  140.  instead.
  141.  Use this qualifier with care.
  142.  
  143. /HFUZZ
  144.  
  145.  /HFUZZ=dimension                             (default=100sp)
  146.  
  147.  Ordinarily, TeX never generates lines that exceed the right margin; if
  148.  it does, it issues an `Overfull /hbox' message.  However, some macro
  149.  packages cause TeX to exceed the margin by a few points or so, and
  150.  these pages, when processed by DVItoLN03, will give rise to warning
  151.  messages if the right margin is exceeded by more than the value
  152.  specified with /HFUZZ.  The default value of this qualifier is 100sp,
  153.  which is invisibly small (it's approximately the wavelength of visible
  154.  light!); using larger values with this qualifier can suppress the
  155.  warning messages.
  156.  Use this qualifier with care.
  157.  
  158. /VFUZZ
  159.  
  160.  /VFUZZ=dimension                            (default=100sp)
  161.  
  162.  TeX is even less likely to write output below the bottom margin of the
  163.  page, but this qualifier can be used analogously to /HFUZZ (q.v.) to
  164.  suppress the resultant warning messages if it does! 
  165.  
  166. /DUPLEX_BY_PAGE_NUMBERS
  167.  
  168.  /DUPLEX_BY_PAGE_NUMBERS (default)
  169.  /NODUPLEX_BY_PAGE_NUMBERS
  170.  
  171.  Specifies whether or not DVItoLN03 should use the page numbers stored
  172.  in the .DVI file for deciding which pages should be printed on left and
  173.  right pages.  Each page may have more than one number, and DVItoLN03
  174.  will use the number (from TeX's \count0).  Pages will be printed on
  175.  alternating right and left pages when /NODUPLEX_BY_PAGE_NUMBERS is
  176.  specified. When /DUPLEX_BY_PAGE_NUMBERS is specified, DVItoLN03 will
  177.  print pages with odd and even numbers on right and left pages
  178.  respectively.  However, if a page has number 0, it will be printed on a
  179.  right page.  The /PRINT_MODE must be specified to enable duplex
  180.  printing.
  181.  
  182. /PRINT_MODE
  183.  
  184.  /PRINT_MODE=(print_mode[,...])
  185.  /PRINT_MODE=(SIMPLEX,NORMAL) (default)
  186.  
  187.  Permits use of extra facilities of newer printers such as the DEClaser
  188.  models 2100 and 2200 (LN05 and LN06).  Some combination of options can
  189.  be used with the traditional LN03 as well.
  190.  
  191.  The options are as follows:
  192.  
  193.  SIMPLEX   Print only on one side of the paper.  This is the default.
  194.  
  195.  DUPLEX    Print on both sides of the paper.
  196.  
  197.  MASTER    Used together with DUPLEX for producing a master for copying.
  198.            This will make the printer print on one side of the paper,
  199.            but insert a blank sheet when the left page in the copies is
  200.            to be blank.  The output is therefore correctly sequenced
  201.            to be photocopied into a double-sided document.  This option 
  202.            can even be used with an ordinary LN03.
  203.  
  204.  TUMBLED   Used together with duplex mode.  MASTER may not be specified.  
  205.            Print left pages upside down.
  206.  
  207.  NORMAL    The opposite of TUMBLED.  This is the default.
  208.  
  209. /FEED_TRAY
  210.  
  211.  /FEED_TRAY=(option=tray_type[,...])
  212.  /FEED_TRAY=ALL=DEFAULT_TRAY (default)
  213.  
  214.  The LN05 printer is capable of selecting paper feed from its paper tray
  215.  or by manual insertion of a sheet or envelope: this could be used, for
  216.  example, to print the first page on a manually-fed sheet of letterhead
  217.  stationery.
  218.  
  219.  The LN06 has two individually selectable paper trays and manual feed as
  220.  standard; in addition, it may be fitted with an optional envelope
  221.  feeder and a large capacity (1000 sheet) external paper tray.
  222.  
  223.  Any of these paper sources may be selected through use of the
  224.  /FEED_TRAY qualifier; the options available are
  225.  
  226.    ALL=tray_type          Feed all sheets from the specified tray
  227.    FIRST=tray_type        Feed the first sheet from this tray
  228.    REST=tray_type         Feed subsequent sheets from this tray
  229.  
  230.  Tray types are specified through use of the following keywords:
  231.  
  232.    DEFAULT_TRAY   TOP_TRAY   BOTTOM_TRAY   ENVELOPE_TRAY  MANUAL_FEED
  233.  
  234. /DEVICE_TYPE
  235.  
  236.  /DEVICE_TYPE=printer_type                      (default: LN03)
  237.  
  238.  Selects the model of printer for which output is being prepared; the
  239.  default value of this qualifier will vary from site to site, but may
  240.  readily be overridden to generate output for a different model.
  241.  
  242.  Values accepted for printer_type are:
  243.  
  244.      LN03   The traditional LN03, or the LN03-plus.  Not the LN03R
  245.             PostScript printer.
  246.      LN05   The DEClaser 2100.
  247.      LN06   The DEClaser 2200.
  248.  
  249. /TFM_DIRECTORY
  250.  
  251.  /TFM_DIRECTORY=file_spec                   (default=TEX$FONTS:)
  252.  
  253.  Specifies where files containing TeX Font Metrics will be found.
  254.  Only use this qualifier if you are a system wizard!
  255.  
  256. /VIRTUAL_DIRECTORY
  257.  
  258.  /VIRTUAL_DIRECTORY=file_spec               (default=TEX$FONTS:)
  259.  
  260.  Specifies where files containing the description of virtual fonts will
  261.  be found.  
  262.  Only use this qualifier if you are a system wizard!
  263.  
  264. /PK_FONT_DIRECTORY
  265.  
  266.  /PK_FONT_DIRECTORY=file_spec               (default=TEX$PK:)
  267.  
  268.  Specifies where files containing packed pixel rasters will be found. If
  269.  the specification (after logical name translation, if necessary) ends
  270.  with the characters ".]", a tree-structured directory will be assumed,
  271.  with fonts of different magnifications held in separate directories. 
  272.  Otherwise, a flat structure is assumed, with the different
  273.  magnifications being distinguishable by different file type extensions.
  274.  Only use this qualifier if you are a system wizard!
  275.  
  276. /PXL_FONT_DIRECTORY
  277.  
  278.  /PXL_FONT_DIRECTORY=file_spec              (default=TEX$PXL_ROOT:)
  279.  
  280.  Specifies where files containing unpacked pixel rasters will be found.
  281.  If the specification (after logical name translation, if necessary)
  282.  ends with the characters ".]", a tree-structured directory will be
  283.  assumed, with fonts of different magnifications held in separate
  284.  directories.  Otherwise, a flat structure is assumed, with the
  285.  different magnifications being distinguishable by different file type
  286.  extensions.
  287.  Only use this qualifier if you are a system wizard!
  288.  
  289. /PAPER_SIZE
  290.  
  291.  /PAPER_SIZE=paper  (Default = A4)
  292.  
  293.  Controls whether the program assumes the use of European A4 (210x297mm)
  294.  paper or US (8-1/2x11in).  It is insufficient just to use this qualifier
  295.  to control the output: it is also necessary to power down the printer, 
  296.  move the paper size switch on the back to the desired setting, and switch
  297.  on again.  Therefore, it is extremely unlikely that this qualifier will
  298.  ever be specified by a user: rather it is present so that the system
  299.  manager can define the default paper size in use at any individual site.
  300.  
  301. 2 Examples
  302.  
  303.  
  304.   DVILN03 LATEX_OUTPUT_FILE
  305.   
  306.   This command converts LATEX_OUTPUT_FILE.DVI to a form suitable for
  307.   printing on a Digital LN03 laser printer. All pages are converted
  308.   for printing in portrait form, starting one inch (300 printer 
  309.   pixels) from the top and left-hand edges of the paper.
  310.  
  311.  
  312.   
  313.   DVILN03/START_PAGE=5.3.2/NUMBER_OF_PAGES=13 LATEX_OUTPUT_FILE
  314.  
  315.   As above, but convert only thirteen TeX pages, starting at TeX 
  316.   page [5.3.2].
  317.  
  318.  
  319.   
  320.   DVILN03/NUMBER_OF_PAGES=20/ORIENTATION=LANDSCAPE LATEX_OUTPUT_FILE;-1
  321.  
  322.   This command converts the immediately previous version of file
  323.   LATEX_OUTPUT_FILE.DVI to a form suitable for printing on a Digital LN03
  324.   laser printer. The first 20 pages are converted for printing in
  325.   landscape form, starting one inch (300 printer pixels) from the top
  326.   and left-hand edges of the paper.
  327.  
  328.   $ DEFINE MY_FONTS 'F$ENVIRONMENT("DEFAULT"),TEX$FONTS:
  329.   $ DEFINE MY_PK    'F$ENVIRONMENT("DEFAULT"),TEX$PK:
  330.   $ TEX/TEXFONTS=MY_FONTS: TESTFONT
  331.   Name of the font to test = myfont
  332.   *\table\bye
  333.   $ DVILN03/TFM_DIRECTORY=MY_FONTS:/PK_FONT_DIRECTORY=MY_PK: TESTFONT
  334.  
  335.   This is one circumstance in which a user might want to use the extra
  336.   qualifiers, for use with a font that has just been built (by METAFONT)
  337.   and is residing in the current directory.  TeX (and DVItoLN03) will
  338.   expect to find MYFONT.TFM in the current directory; failing that it
  339.   will look, as usual, in the directory indicated by TEX$FONTS.
  340.   DVItoLN03 will in addition look for MYFONT.300PK in one of those
  341.   places.
  342.   
  343.   
  344.   DVILN03 /PRINT_MODE=DUPLEX /NODUPLEX_BY_PAGE_NUMBERS -
  345.      /FEED_TRAY=(FIRST=MANUAL_FEED,REST=TOP_TRAY) LATEX_OUTPUT_FILE
  346.  
  347.   Converts LATEX_OUTPUT_FILE.DVI to a form suitable for printing on the
  348.   DEClaser 2200.  Pages are printed on both sides of the paper,  and
  349.   DVItoLN03 does not insert blank pages when page numbers indicate it.
  350.   The first sheet of paper must be manually fed, and the rest are taken
  351.   from the top tray. 
  352.